home *** CD-ROM | disk | FTP | other *** search
/ Tricks of the Mac Game Programming Gurus / TricksOfTheMacGameProgrammingGurus.iso / More Source / C⁄C++ / MacWT 0.77 / Read Me First! < prev    next >
Text File  |  1995-04-13  |  9KB  |  133 lines

  1. MacWT 0.77
  2. A 3-D Graphics Engine for 680x0 or PowerPC
  3.  
  4. Thank you for trying MacWT, by Bill Hayden and Nikol Software.
  5.  
  6.  
  7. What is MacWT?
  8. MacWT is an easy-to-use 3-D graphics engine, based on the cross-platform wt engine originally developed by Chris Laurel.  MacWT was built from a base of wt 0.05c1 with the exception of those changes from b to c1 which broke the floor/ceiling rendering code.  The first version of MacWT was created by Turlough O'Connor in early 1994.  While the current MacWT is based on Mr. O'Connor's MacWT 0.04, little of the original code remains.
  9.  
  10. MacWT has been tested on the following computers:
  11. Macintosh IIci
  12. Macintosh IIcx
  13. Quadra 840av
  14. Quadra 650 w/PowerPC upgrade card
  15. PowerMac 7100/66
  16. PowerMac 8100/80
  17.  
  18. What is required to run MacWT?
  19. You will need a 68020, 68030, or 68LC040 with an FPU; a 68040; or a PowerPC to run MacWT.  MacWT requires at least 700k to run, and prefers 2000k or more with medium to large world files.  MacWT requires System 7 or above.
  20.  
  21. How do I move around the MacWT world?
  22. MacWT uses a (hopefully) very intuitive set of movement keys.  They are as follows:
  23. Forward - 8 or Up Arrow
  24. Back - 2 or Down Arrow
  25. Turn Left - 4 or Left Arrow
  26. Turn Right - 6 or Right Arrow
  27. Jump - Space Bar
  28. Accelerate Movement - Shift key
  29. Slide Sideways - Control + {Turn Right or Turn Left}
  30. Action Keys - w, e, r, t   (Defined for future use - right now they are just set to jump)
  31. Toggle between mouse/keyboard control - y
  32. Pause - Tab key
  33. Quit - Escape key
  34.  
  35. Selecting "New Game" from the file menu or pressing the forward key starts the simulation.
  36.  
  37. Where can I find the latest version?
  38. You can always find the up-to-the-day latest version of MacWT and its source via anonymous FTP from gopher.circa.ufl.edu/pub/software/ufmug/mirrors/LocalSW/Hayden/ or on the web at http://grove.ufl.edu:80/~nikolsw.  This web address may no longer be valid starting in 1996.  Don't worry, though, as you can also find MacWT updates on America On-Line and the common internet sites, such as UMich and Info-Mac.  If you are doing serious MacWT work, feel free to get in touch with me personally at bmoc1@aol.com or at the address listed below.
  39.  
  40. What is the version history?
  41. New Features in 0.77:
  42. • Another interim release to fix a nasty bug which crashed MacWT if you started the game with 'New Game' instead of just hitting one of the forward keys.
  43. • Removed .ppm texture support. (the routines were buggy and of little use on the Mac anyway)
  44. • Updated 68k fixed-point math routines, giving 1% improvement on 68k machines. (every little bit helps!)
  45. • Minor internal modifications moving toward 16- and 24-bit color capability. (look for this in 0.80)
  46.  
  47. New Features in 0.76:
  48. • Interim release to fix source code problem. (I included the 0.60 resource file with the 0.70 source release)
  49. • Direct blitting code added.
  50. • Minor internal fixes.
  51. • PICT & PICT-R loading code finished & operational, but it still pops up an unsightly loading window.
  52.  
  53. New Features in 0.70:
  54. • Wall collision detection, with almost zero reduction in rendering speed!  And I though this one was going to be so difficult!
  55. • Introduction of an editable physics model, contained in the 'Phys' resource #128 inside MacWT.
  56. • Internal changes and clean-up to make way for future enhancements.
  57. • Fixed a bug which crashed MacWT when you quit with cmd-Q after loading was done but before starting a game.
  58. • MacWT now displays the simulation centered, with a black background.
  59. • Window zooming functionality has been removed.
  60. • Paused look has been changed to resemble games such as Marathon and Pathways into Darkness.
  61. • Pressing the option key during application start-up quits all other applications, providing a slight speed boost.
  62.  
  63. New Features in 0.60:
  64. • Floor and ceiling collision detection - you can now climb stairs, hit your head on the ceiling, etc.
  65. • World edge collision detection - no more falling off the edge of the world
  66. • Movement via the mouse (y key toggles mouse/keyboard control)
  67. • Mouse control accelerates rendering by about 8% by bypassing the main event loop
  68. • Escape key quits MacWT
  69. • The control key is now the only strafe key - I removed the rarely (never?) used / key from this functionality.
  70.  
  71. New features in 0.05b+:
  72. • The view size can be selected (this is not a scaled view, but a true view size setting).
  73. • The concept of a "default file" has been removed.  MacWT now prompts the user for a world file on application startup if one was not opened from the Finder.
  74. • World files can now be double-clicked or drag-opened from the Finder to be opened in MacWT, since world files are now MacWT documents, with their own icons. (Creator McWt and Type TEXT)
  75. • MacWT now uses the Macintosh's standard 256 color palette instead of loading a 192 color PC palette.  MacWT loads faster and renders much cleaner and better now.
  76. • MacWT now displays a much more accurate frame-per-second counter.
  77. • MacWT now automatically switches to 8-bit color on start-up, and switches back to the previous bit depth on exit.  This is temporary, of course, until 16-bit support is added.
  78. • MacWT now checks for the existence of an FPU on 680x0 machines, and quits if one is not available.
  79. • Mr. O'Connor's direct screen writing code has been removed.  It was becoming a heavy restriction to the improvement of MacWT and it offered little or no speed improvement.  I will add some new direct-screen writing code when I find/write some.
  80. • All of Chris Laurel's innumerable wt improvements from 0.04a to 0.05c1, including rendering speed-ups, rendering glitch fixes, fixed-point speed-ups, partial 16-bit color support, support for standard texture file formats such as GIF, object gravity and physics, floor and ceiling collision detection, and many more.
  81.  
  82. What kind of performance can I expect?
  83. Using the two example files that come with MacWT, here are some benchmarks I obtained at the standard view size (320 x 200):
  84. On a 50MHz IIci, "small.world" averaged about 4.9 frames per second.
  85. On a 50MHz IIci, "huge2.world" averaged about 2.3 frames per second.
  86. On a 66MHz 7100/66, "small.world" averaged about 34 frames per second. (39 fps with System 7.5.1 MathLib)
  87. On a 66MHz 7100/66, "huge2.world" averaged about 21 frames per second. (26 fps with System 7.5.1 MathLib)
  88.  
  89. Incredibly, but perhaps not surprisingly, the additon of the new native MathLib on PowerMacs instantly improves performance by almost 15%, as shown in parentheses.
  90.  
  91. On a 66MHz 7100/66, "small.world" averaged about 21.7 fps at the largest view size (480 x 300), under System 7.5.1.
  92.  
  93. No, I meant how fast can it go?
  94. On a 66MHz 7100/66, "small.world" averaged just under 56 fps at the (240 x 150) view size, under System 7.5.1.  Fast enough for ya?  Imagine a PowerMac 8100/110...  Pentium users: Chew on that figure for awhile, and don't forget that collision detection is fully active for that figure, so let's not compare Apples and oranges (or was it lemons?).
  95.  
  96. What are the known bugs?
  97. The rendering engine still contains a few gliches left over from its wt days:
  98. 1. MacWT renders floors and ceilings 1-pixel off from the right edge of the screen, yet walls and sky are rendered OK.
  99. 2. Ceilings are occasionally clipped when looking through a "hole" in a wall.
  100. 3. You can jump or move while in mid-air.
  101.  
  102. Plus, some new and imporved bugs have popped up:
  103. 4. There appears to be a memory leak - this may be new or old, I'm not sure.  It's especially apparent when using the large view sizes on the PowerPC.
  104. 5. Wall collision detection is excellent, with one exception: it has problems when running into positive corners (i.e. not the "go sit in the corner" corner, but outward poking corners, like the outside corner of a cube)
  105.  
  106. What is the future of MacWT?
  107.  I hope to add several features over the next few weeks/months.  Here are the proposed features in no particular order:
  108. • 16-bit color support (partially completed)
  109. • Moveable 2-D Sprites (I or someone else just needs to implement the 0.05c1 version of render.c and slice.c, but this is much easier said than done.)
  110.  
  111. While I will try to add the items listed above, I will attempt to keep MacWT at a level where developers can use it right away.  I was thinking of adding asyncronous sound routines, speech, etc., but on second thought, I realized that I never wanted to reach a point with MacWT where developers had to spend time taking something out to use it like they wanted to.  It's daunting enough as it is - I don't want to add unneeded complexity.
  112.  
  113.  
  114. If you have any comments or suggestions about MacWT (or anything else, for that matter) drop me a line anytime.
  115.  
  116. Snail Mail:
  117. Nikol Software
  118. c/o William Hayden
  119. 1325 NE 9th Street
  120. Gainesville, FL  32601-3720
  121.  
  122. Internet:
  123. bmoc1@aol.com
  124.  
  125. Anonymous FTP:
  126. ftp.circa.ufl.edu/pub/software/ufmug/mirrors/LocalSW/Hayden/
  127.  
  128. WWW:
  129. http://grove.ufl.edu:80/~nikolsw   (valid until early '96)
  130.  
  131. Home Phone:
  132. (904) 378-2938
  133. Please be aware that I will not accept collect calls.